Public Function duplicate_cr(ByVal cr_id As String, _
ByVal the_status As String, _
ByVal master_cr As String, _
ByVal user_name As String, _
ByVal close_date As String, _
ByVal gen_time_bombs As Boolean) As Integer
Description
This API closes the specified CR as a duplicate of the "master CR". The CR is placed in "CR Duplicate/Closed" condition, and in the specified status. You may specify the user performing the duplication, as well as when it occurred. A time bomb may be generated for business rule notification.
Parameters
Parameter Name Required? Description
cr_id Yes The change request to mark as a duplicate
the_status No The new status for the duplicate CR. If blank, the default status for
the condition is used
master_cr Yes The ID of the master (parent) CR
user_name No The user who duplicated the change request. If left blank, the current user performs the marking
close_date No When was the duplication. If blank, the current date/time is used
gen_time_bombs Yes Should a time_bomb be generated (for notifications/business rules)
Returns
Value Meaning
0 No errors
-1 Cannot find the specified change request
-2 The CR is already closed
-3 The CR is currently dispatched
-4 Cannot find the specified user
-5 Cannot find gbst_elm rank 7300 for string CHG STS:DUPL
-6 Cannot find the new status
-7 Cannot find the master CR
-8 The master CR is already marked as a duplicate
-9 Status transition not defined in Policies and Customers
-10 Status transition not allowed for specified user
-18 Privclass not found for specified user
-19 Old status not found for old condition
-20 New status not found for new condition
-21 Cannot find the specified user's employee record for relating time bomb
Examples
· Mark CR '2' as a duplicate of CR '4' with a new status of 'Double Entry". Gary performed the close at 8AM on March 29, 1999. Generate a time bomb.
Visual Basic:
Dim ret_int As Integer
ret_int = fccq.duplicate_cr("2", "Double Entry", "4", "gary", _
"3/29/99 08:00:00", True)
JavaScript:
var ret_int = fccq.duplicate_cr("2", "Double Entry", "4", "gary",
"3/29/99 08:00:00", true);